Manual de Usuario

MatComCare

1. Nombre del software

MatComCare

Aplicación web para la gestión integral de los procesos de un policlínico docente.

2. Autores

Melissa Maureen Sales Brito [C-311] — @Maureen011
Ramón Cherta González [C-311] — @ramonchg04
Ronal Prieto Vázquez [C-311] — @rpv_8
John Mauris López Ramos [C-312] — @John3_141592

3. Objetivos del proyecto

El proyecto tributa a la evaluación de las asignaturas Bases de Datos II e Ingeniería de Software, integrando conceptos de diseño de software y bases de datos robustas.

En un policlínico docente se manejan diariamente múltiples procesos que abarcan desde la atención a pacientes hasta la gestión interna de los recursos. Actualmente, muchos de estos procesos se realizan de manera parcial o totalmente manual, lo que provoca: - Pérdida de tiempo. - Duplicación de datos. - Dificultades en la trazabilidad de la información.

Objetivo general

Desarrollar una aplicación web integral que permita centralizar y automatizar la gestión de los principales procesos del policlínico docente.

Objetivos específicos

Centralizar la información clínica y administrativa.
Automatizar la gestión de pacientes, personal, consultas e inventario.
Mejorar la trazabilidad de la información.
Facilitar la comunicación entre las distintas áreas del policlínico.
Proveer reportes y estadísticas para apoyar la toma de decisiones.

4. Requerimientos técnicos

La aplicación está diseñada para ejecutarse localmente en la computadora del usuario, ya que se trata de un proyecto académico sin despliegue en servidores reales.

Hardware mínimo recomendado

Recurso	Requisito
Procesador	Doble núcleo (Intel i3 o equivalente)
Memoria RAM	4 GB mínimo (ideal 8 GB)
Almacenamiento	2 GB libres para dependencias, `node_modules` y base de datos
Resolución de pantalla	1366×768 o superior

Consideraciones técnicas

El sistema ejecuta simultáneamente backend, frontend, base de datos y navegador.
No se emplean tecnologías pesadas como microservicios.
Todo el sistema funciona sobre localhost.

5. Requerimientos de software

Software requerido para el Backend (.NET + PostgreSQL)

Software	Versión	Propósito
.NET SDK	8.0 o superior	Ejecutar el backend (`dotnet run`)
PostgreSQL	14 o superior	Base de datos local
Npgsql Provider	Incluido en el proyecto	Comunicación .NET – PostgreSQL
Swagger	Incluido	Pruebas de endpoints

Ejemplo de cadena de conexión: Host=localhost; Port=5432; Database=polyclinicDb; Username=user_medical; Password=polyclinic.

Software requerido para el Frontend (React)

Software	Versión	Propósito
Node.js	18 o superior	Ejecutar `npm start`
NPM	Incluido	Instalación de dependencias
Navegador moderno	Chrome / Firefox / Edge	Acceso a la aplicación

Configuración de conexión al backend:

const API_BASE_URL =
  process.env.REACT_APP_API_URL || 'https://localhost:7060/api';

6. Forma de instalar la aplicación

6.1 Clonar repositorios

git clone https://github.com/polyclinic-project-2025/polyclinic_frontend.git
git clone https://github.com/polyclinic-project-2025/polyclinic_backend.git

6.2 Configurar la base de datos PostgreSQL

CREATE USER user_medical WITH PASSWORD 'polyclinic';
CREATE DATABASE polyclinicDb OWNER user_medical;
GRANT ALL PRIVILEGES ON DATABASE polyclinicDb TO user_medical;

6.3 Migración

cd polyclinic_backend/PolyclinicApi

dotnet ef migrations add InitialMigration   --project ../PolyclinicInfrastructure/PolyclinicInfrastructure.csproj   --startup-project ../PolyclinicApi/PolyclinicApi.csproj   --verbose


dotnet ef database update \
  --project ../PolyclinicInfrastructure/PolyclinicInfrastructure.csproj \
  --startup-project ../PolyclinicApi/PolyclinicApi.csproj \
  --verbose

6.4 Ejecutar el backend

cd polyclinic_backend/PolyclinicApi
dotnet run

6.5 Ejecutar el frontend

cd polyclinic_fronted/polyclinic-fronted
npm run
npm start

7. Opciones del sistema

Las opciones del sistema dependen del rol del usuario autenticado (admin, doctor [jefe de departamento], jefe de almacén, paciente).

7.1. Registrarse en la plataforma

7.1.1. Si no tiene cuenta y su perfil es reconocido por el policlínico como paciente o empleado puede registrarse

7.1.2. Introduzca su correo

7.1.3. Introduzca su rol

7.1.4. Introduzca su identificación

7.1.5. Cree una contraseña segura

7.1.5. Confirme su contraseña

7.1.6. Crear cuenta y loguo automático

7.2.1. Si ya tiene cuenta puede loguearse, introduzca su correo

7.2.1. Introduza su contraseña

7.2.1. Inicie Sesión

7.3. Pagina principal

Todos tienen acceso a ella, muestra estadísticas generales del policlínico.

7.4. Pacientes

Acceso permitido a admin, doctores y enfermeros

7.4.1. Creacion de pacientes

Permitida al personal de salud

7.4.2. Rellene los datos solicitados y cree el paciente. Elija la opción adecuada para derivar o remitir al paciente

7.5. Consultas

Existen consultas por derivación interna y por remisión medica, elija el tipo que desea. #### 7.5.1. Creación de consultas Las consultas solo pueden ser creadas por doctores.

7.5.2 Asignar medicamentos

7.6. Cuerpo de Guardia

7.6.1. Guardias

El admin pueden asignar el turno de guardia, conformado por un doctor.

7.6.2. Atenciones

Tambien es posible crear atenciones con medicamentos asignados a un paciente por el doctor de guaridia, luego es posible navegar por el historial de urgencias.

7.7. Departamentos

Los departamentos solo pueden ser creados/editados/eliminados por el admin, el resto de empleados tiene acceso a la lista de estos.

7.8. Medicamentos

Los medicamentos solo pueden ser creados/editados/eliminados por el admin, el resto de empleados tiene acceso a la lista de estos.

7.8.1. Detalles de un medicamento en particular

7.9. Almacén Central

A este tiene acceso el admin para definir un jefe. Los doctores pueden hacer solicitudes, luego estas quedan a la espera de ser aprobadas por el jefe de su departamento y posteriormente por el jefe de almacén.